home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / e-tools / plugins / plugin_bitmap / plugin_bitmap.doc < prev    next >
Encoding:
Text File  |  1996-04-11  |  3.0 KB  |  91 lines
  1. Quick Reference "Plugin_Bitmap.m"  © 1996 by Sebastian Hesselbarth
  2.  
  3.  
  4. +--------- --- -- - -  Introduction
  5.  
  6. This Archive contains a PLUGIN written for the AmigaE-GUI-Designer
  7. called EasyGUI ! It has been compiled with AmigaE-version 3.2e and I think
  8. you need at least this version (> 3.2a) to use this module !
  9. So if you don't have this version contact your national E distibutor to
  10. buy/upgrade you AmigaE compiler. (Greetings to Joerg Wach ;) )
  11.  
  12. Right... I wrote this module to make it possible for EasyGUI programmers to
  13. display simple bitmaps in their GUIs.
  14. Therefore this module is able to display a bitmap in an EasyGUI-window and
  15. you can scroll the bitmap using sliders and arrowbuttons in the case the
  16. bitmap is larger than the display field !
  17.  
  18. Some routines (createbitmap(), min(), max(), rassize(), aso..) were taken from
  19. Wouter's ScrollerWindow.e source. I hope he won't kill me :)
  20.  
  21. +--------- --- -- - -  Legal stuff
  22.  
  23. The programs and modules in this archive are
  24. Copyright © 1996 by Sebastian Hesselbarth.
  25.  
  26. Further the Plugin_Bitmap module and the source are dedicated to
  27.   the author of the AmigaE language Wouter van Oortmerssen ...
  28.  
  29. You are free to include the module in your programs, whether free-/pubilc-
  30. share-/"whatever"-ware or commercial. 
  31. The only thing that's a must is that the archive must be complete and must
  32. contain all files unmodified.
  33.  
  34. I make no guaranties that this module is totally bug-free or work as expected.
  35. This module is not really betatested so if you find any bug/error : contact me!
  36.  
  37. Finally I must say that it is your _own_ risk if you use this module and your
  38. AMIGA® travels in to the deepest abysses of the Himalaya. (Greets 2 the GURU ;)
  39. Or you harddisk reaches the NIRVANA while you use my program.
  40. In this case I can only say : "sorry pals!". ;)
  41.  
  42. +--------- --- -- - -  Requirements
  43.  
  44. - GBytes of memory ... :)))) JOKE !!
  45.  
  46. * You need at least OS 2.0 (Upgrade pals !)
  47. * For programing you need AmigaE v3.2a+
  48. * For extremly large bitmaps you _really need_ GBytes of memory !
  49. * Calc with (width * height * depth)/8 for memory usage !
  50.  
  51. +--------- --- -- - -  Usage
  52.  
  53. This module uses the standard PLUGIN routines (are there any other ? ;)
  54. so you only ... have to look up in my example source or any other 
  55. source that uses plugins ...
  56.  
  57. The easiest way is this :
  58.  
  59. DEF bm : PTR TO bitmap_plugin 
  60.  
  61. easygui('Title',
  62.   ...
  63.   [PLUGIN, 1, NEW bm.init (bitmap,width,height,depth)
  64.   ...
  65.   
  66. Where "bm" is a pointer to "bitmap_plugin" :)
  67. You must start "bm" with the "init" procedure ... the arguments are :
  68.  
  69. bitmap = PTR TO a memory area that contains a bitmap structure
  70. width  = The width of "bitmap"
  71. height = ... ^^^
  72. depth  = ... ^^^
  73.  
  74. It's so simple isn't it ? Anyway you have problems with it contact me ...
  75.  
  76. +--------- --- -- - -  The Author
  77.  
  78. I'm still in school so don't blame me for grammatical errors ! ;)
  79.  
  80. Sebastian Hesselbarth
  81. Multhoepen 13
  82. 31855 Aerzen
  83. GERMANY
  84.  
  85. Tel. 05154 / 8051
  86. (international : ++49-(0)515-480-51)
  87.  
  88. Contact me for suggestions, bugs or just to start a project with me :)
  89. Sorry, no email yet .. but I hope it will come soon...
  90.  
  91. bye and happy programmin' !!